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(ON Z-TaVITaN 


LiveCode 8.1 provides important improvements for delivering high-quality cross-platform 
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applications! 


LiveCode Indy and Business editions now come with the tsNet external, which supercharges 
LiveCode's Internet features and performance. LiveCode 8.1 also introduces mergHealthkit, 
for accessing activity, sport and health data on iOS devices. 


The standalone builder now has a greatly-improved user experience for including externals, 
script libraries and LiveCode Builder extensions in your cross-platform application. Usually, 
it'll now do the right thing automatically, but you can still select the specific inclusions you 
need. 


The IDE has lots of other upgrades, too: a keyboard-navigable Project Browser that 
highlights any scripts that failed to compile, an improved dictionary user interface, and 
access to the message box just by starting to type. 


The player control can be used in Windows application without any need for users to install 
any additional libraries or dependencies, thanks to a brand new player implementation 
based on DirectShow. For most apps, it should now be unnecessary to install or use 
QuickTime at all. 


The LiveCode Builder programming language has had some enhancements as part of the 
Infinite LiveCode project. Variables now get initialised by default, unsafe blocks and 
handlers can be used to flag sections of code that do dangerous things, and you can even 
include raw bytecode if necessary. 


Known | = 


The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


The browser widget does not work on 32-bit Linux. 


64-bit standalones for Mac OS X do not have support for audio recording or the 
revVideoGrabber external. 


The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 


LiveCode supports the following versions of Windows: 


Windows XP SP2 and above 

Windows Server 2003 

Windows Vista SP1 and above (both 32-bit and 64-bit) 
Windows 7 (both 32-bit and 64-bit) 

Windows Server 2008 

Windows 8.x (Desktop) 
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e Windows 10 


Note: On 64-bit Windows installations, LiveCode runs as a 32-bit application through the WoW 
layer. 


Linux 


LiveCode supports the following Linux distributions, on 32-bit or 64-bit Intel/AMD or compatible 
processors: 


e Ubuntu 14.04 and 16.04 

e Fedora 23 & 24 

e Debian 7 (Wheezy) and 8 (Jessie) [Server] 
e CentOS 7 [server] 


LiveCode may also run on Linux installations which meet the following requirements: 
e Required dependencies for core functionality: 


° glibc 2.13 or later 
o glib 2.0 or later 


e Optional requirements for GUI functionality: 


°0 GTK/GDK 2.24 or later 

o Pango with Xft support 

° esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

© Icms (optional, required for color profile support in images) 
© gksu (optional, required for privilege elevation support) 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 


Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 
The Mac engine supports: 


e 10.6.x (Snow Leopard) on Intel 
e 10.7.x (Lion) on Intel 

e 10.8.x (Mountain Lion) on Intel 
e 10.9.x (Mavericks) on Intel 

e 10.10.x (Yosemite) on Intel 

e 10.11.x (El Capitan) on Intel 

e 10.12.x (Sierra) on Intel 
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iOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 


Currently, the supported versions of Xcode are: 


e Xcode 4.6 on MacOS X 10.7 

e Xcode 5.1 on MacOS X 10.8 

e Xcode 6.2 on MacOS X 10.9 

e Xcode 6.2 and 7.2 on Mac OS X 10.10 
e Xcode 8.2 on MacOS X 10.11 

e Xcode 8.2 on MacOS 10.12 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
simulators. For instance, on OS X 10.10 (Yosemite), you can add Xcode 5.1 in the Mobile Support 
preferences, to let you test your stack on the /OS Simulator 7.1. 


We currently support deployment for the following versions of iOS: 


e 6.1 [simulator] 
e 7.1 [simulator] 
e 8.2 [simulator] 
e 9.2 

e 10.2 


Android 


LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


The Android engine supports devices using ARMv6, ARMv7 or ARMV8 processors. It will run on the 
following versions of Android: 


e 2.3.3-2.3.7 (Gingerbread) 
e 4.0 (Ice Cream Sandwich) 
e 4.1-4.3 (Jelly Bean) 

e 4.4 (KitKat) 

e 5.0-5.1 (Lollipop) 

e 6.0 (Marshmallow) 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the 'Android SDK Manager' to install: 


e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
"openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 
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Some users have reported successful Android Watch deployment, but it is not officially supported. 


HTML5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
JavaScript and using modern HTML5 JavaScript APIs. 


HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 


Ce 


Installation 


Each version of LiveCode installs can be installed to its own, separate folder. This allow multiple 
versions of LiveCode to be installed side-by-side. On Windows (and Linux), each version of 
LiveCode has its own Start Menu (or application menu) entry. On Mac OS X, each version has its 
own app bundle. 


On Mac OS X, install LiveCode by mounting the .dmg file and dragging the app bundle to the 
Applications folder (or any other suitable location). 


For Windows and Linux, the default installation locations when installing for "All Users" are: 


Platform Path 
Windows <x86 program files folder>/RunRev/LiveCode <version> 


Linux /opt/livecode/livecode-<version> 


The installations when installing for "This User" are: 


Platform Path 

Windoue suse (esting app data folder>/RunRev/Components/LiveCode 
<version> 

Linux ~/.runrev/components/livecode-<version> 


Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 


On Mac OS X, drag the app bundle to the Trash. 
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On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
LiveCode's installation directory. 


Reporting installer issues 


If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 


Platform Path 
Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 


Linux <home>/.runrev/logs 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 


Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 


Command-line installation 


It is possible to invoke the installer from the command-line on Linux and Windows. When doing 
command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 


Run the installer using a command in the form: 


<installer> install noui [OPTION ...] 


where <installer> should be replaced with the path of the installer executable or app (inside 
the DMG) that has been downloaded. The result of the installation operation will be written to the 
console. 
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Option Description 


Install the IDE for "All Users". If not specified, LiveCode will be installed 


-allusers 
for the current user only. 


Place a shortcut on the Desktop (Windows-only) 


desktopshortcut 

-startmenu Place shortcuts in the Start Menu (Windows-only) 

-location The folder to install into. If not specified, the LOCATION defaults to those 
LOCATION described in the "Installation" section above. 

pqulocrite Pees to log installation actions. If not specified, no log is 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 


As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


start /wait <installer> install noui [OPTION ...] 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 


Run the uninstaller using a command of the form: 
<uninstaller> uninstall noui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 


Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
command-line arguments to LiveCode. 
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Activate LiveCode using a command of the form: 


<livecode> activate -file LICENSEFILE -passphrase SECRET 


where <Livecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 
given SECRET passphrase, and installs a license file for all users of the computer. Manual 


activation files can be downloaded from the My Products page in the LiveCode account 
management site. 


It is also possible to deactivate LiveCode with: 

<livecode> deactivate 

Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


start /wait <livecode> activate -file LICENSE -passphrase SECRET 
start /wait <livecode> deactivate 


On Mac OS X, you need to do: 


<livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<livecode>/Contents/MacOS/LiveCode deactivate 


aleiial= lalet= 


Ensure CMYK JPEGs display correctly on Mac (8.1.3-rc-1) 


This fixes the incorrect rendering of CMYK JPEGs containing an ICC profile on Mac. 


Add builtin implementation of field 'Select All’ (8.1.3-rc-1) 


The field control will now understand Cmd/CtrI+A as the 'Select All' action - causing the whole text 
of the field to be selected. 


Improve efficiency of compiled regex cache (8.1.3-rc-1) 


The efficiency of lookups of previously compiled regexs has been improved. To take full advantage 
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of the regex cache make sure that you either use a string constant for the regex pattern, ora 
variable which is not mutated between uses. e.g. 


get matchText(tTarget, "Someregexpattern") -- efficient 
get matchText(tTarget, tUnchangedPatternVar) -- efficient 
get matchText(tTarget, tPatternPrefix & tPatternSuffix) -- inefficient 


In general you will only gain advantage from the regex cache if you repeated use the same regex 
pattern in the way described above repeatedly in a tight loop. 


Ensure matchText and replaceText don't affect target string 
(8.1.3-rc-1 


Previously calling matchText or replaceText on a string would cause subsequent uses of that 
string to use slower codepaths causing unexpected performance degredation. 


Specific engine bug fixes (8.1.3-rc-2) 


19105 Resolve crash when deleting a stack in the message path in a front script 

Ensure substacks with cantDelete don't cause execution errors when deleting the 
mainstack 

19121 Pass correct folder to standaloneSaved message 

19158 Prevent crash when using undo to bring back removed controls 

19185 Ensure the dragData["private"] isn't cleared during a drag 


19120 


Specific engine bug fixes (8.1.3-rc-1) 


11313 Support mobilePickPhoto() maximum width and height settings on Android 
13055 Improve formatting of try syntax description 

13151 Correct example of setting "listIndent" for whole field 

13370 Correct terminology in "convert" command documentation 

14080 _ Fix find command not finding in specified field when not on current card 
17918 Make sure setting clipboarddata["text"] and clipboarddata["htm!"] works as expected 
17973 Make sure the machine can distinguish between iOS device and simulator 
18264 Don't fail standalone build completely if unlicensed platforms are selected 
18277 Calculate the height of the mac desktop space correctly 

18295 Fix empty specialFolderPath("resources") on Windows 

18353 Remove duplicated urlResponse documentation 

18392 Ensure "ceiling" is listed as a reserved word 

18443 Ensure 'private' clipboard is reset when another application sets the clipboard 
18459 _ Fix incorrect behavior of files() and folders() function on Android. 

18514 Make sure setting clipboarddata["html"] works as expected on Windows 
18600 Fix crash when quitting from script editor 

18610 Add code examples to tsNet dictionary entries 
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18632 
18652 
18666 
18686 
18724 
18738 
18755 
18762 
18778 
18852 
18870 
18871 
18873 
18890 
18893 
18894 
18923 
18925 
18938 
18948 
18959 
18969 
18977 
18982 
18988 
19003 
19004 
19005 


19008 


19009 
19010 
19017 
19024 
19032 
19036 
19044 
19045 
19049 
19050 


19051 


19076 
19084 
19088 


LiveCode 8.1.3 Release Notes 2/20/17 


Mark the copyResource function as deprecated 

Fix occasional crash when getting the clipboarddata["text"] on Windows. 

Fix crash when find command matches text in sharedText field on non-current card 
Fix a crash related to the message watcher 

Fix incorrect cross-references in lockLocation dictionary entry 

Fix data loss when cr inserted into a styledText run 

Fix loss of BMP as supported clipboard image format 

Fix a rare crash on saving after cloning a field 

Send standalone saving messages at correct time 

Fix exception thrown in IDE when saving standalone with more than one stack 
Fix crash caused by calling tsNetGetSync() repeatedly against the same URL 
Add support for upper and lower case field shortcuts on Mac 

Fix documentation of valid values for lineSize property 

Fix crash when playing non-imported audioclip 

Fix formatting in description of stack mode property 

Don't strip context tags from HTML clipboard formats 

Ensure CMYK JPEGs display correctly on Mac 

Prevent crashes on memory exhaustion 

Fix text encoding issues when pasting HTML into LiveCode 

Make 'obj of me' consistent across all control types 

Fix crash after getting the points of a regular polygon graphic 

Add builtin implementation of field 'Select All’ 

Ensure setting the card triggers openCard / closeCard in no UI mode 
Improve shift+click behavior of text selection in XPDF 

Deal with stack id cache correctly on stack delete 

Stackfiles under the mainstack path preserve folder structure in standalone 
Improve efficiency of compiled regex cache 

Ensure matchText and replaceText don't affect target string 

Place modals at their own location when neither the defaultStack or topStack can 
provide useful relative locations 

mergExt external builds for iOS 10.2 

Provide iOS 10.2 builds for tsNet 

Fix crash when deleting object which is being moved 

Prevent crash when calling mobileStoreRequestProductDetails 

Prevent crash when creating and deleting two data grids 

Fix incorrect local file path when setting url of browser widget on Android. 
Prevent crash when deleting stack which has an open substack 

Fix BiDi algorithm for surrogate pairs 

Prevent crash when deleting mousestack stack via button click 

CGI does not work with lighttpd 1.4.44 

Make sure the player endtime property cannot be set to a value greater than the 
player duration 

Prevent redraw recursion when going to stack twice in no ui mode 

Ensure text is copied as unstyled on mac 

Do not show "Success" dialog if an error occurred in S/B 
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19093 
19097 
19108 
8274 
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Prevent recursion when fetching mouseColor in mouseMove handler 
Ensure all menus are updated after mouseDown to menu group 
Correct references for scriptOnly property docs 

Improve modal placement documentation 


IDE Changes SSS 


Allow substack to become a mainstack via property inspector 
(8.1.3-rc-1 


The property inspector Basic pane for substacks now has a button beneath the mainstack labelled 
"Make mainstack". Note that once pressed this button will disappear, as the stack will no longer a 


substack. 


Reinstate store tab of extension manager (8.1.3-rc-1) 


The store tab of the extension manager has been reinstated and the revBrowser implementation 
has been replaced with a browser widget. 


Specific IDE bug fixes (8.1.3-rc-1) 


15917 


17889 
18177 
18302 


18393 


18491 
18586 
18701 


18726 
18804 
18897 


18930 
18981 
18987 
19015 


Font Size for Project Browser can now be set from LiveCode Preferences -> Project 
Browser 

Repaired confusing layout of fill gradient control in Property Inspector 

Reinstate text properties and graphic effects to datagrid inspector 

Retain custom prop changes when clicking on tree view in editor 

[Project Browser] Change "Sort controls by number" to "Sort controls by layer" to 
avoid confusion + make sure they are sorted numerically 

Allow substack to become a mainstack via property inspector 

Make sure the Project Browser stack/card/group view can always expand 

Prevent over-enthusiastic save prompts 

Make sure the Bug Report checkmark appears at the correct place in Standalone 
Settings 

Update locked inspectors when mainstack names change 

"Show Sections" for Project Browser can now be set from LiveCode Preferences -> 
Project Browser 

Reinstate store tab of extension manager 

Added tooltip to iOS icon and splash screen selection 

Reinstate fixedLineHeight for tableField 

Reset the templateStack after datagrid creation 
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Specific LCB bug fixes (8.1.3-rc-1) 


18856 Use cached numeric values when converting numbers to/from strings 


LiveCode extension changes 


Tree View widget 


Limit display calculations 


Previously when an array was expanded in the Tree View widget, all of the display calculations for 
were done before the next redraw. Now the keys are sorted (as before) but the display 
calculations are made for a maximum of 1000 rows. When more rows are needed due to scrolling, 
another 1000 are calculated at that point. This provides a near-continuous scrolling experience for 
arrays with large numbers of keys, and ties the expense of expanding an array to that of sorting 
its keys. 


Specific extension bug fixes (8.1.3-rc-1) 


18500 Ensure color properties are documented correctly 
18693 Prevent long delays when expanding arrays with many keys 
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